<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="Content-Script-Type" content="text/javascript" />
<title>Preface</title>
<meta name="generator" content="Oracle DARB XHTML Converter (Mode = document) - Version 5.1.2 Build 015" />
<meta name="date" content="2011-11-03T11:27:16Z" />
<meta name="robots" content="noarchive" />
<meta name="doctitle" content="Preface" />
<meta name="relnum" content="Release 1.5" />
<meta name="partnum" content="E23376-02" />
<link rel="copyright" href="./dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
<link rel="stylesheet" href="./dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
<link rel="index" href="index.htm" title="Index" type="text/html" />
<link rel="prev" href="title.htm" title="Previous" type="text/html" />
<link rel="next" href="intro.htm" title="Next" type="text/html" />
</head>
<body>
<div class="header"><a id="top" name="top"></a>
<div class="zz-skip-header"><a href="#BEGIN">Skip Headers</a></div>
<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td align="left" valign="top"><b>Lightweight UI Toolkit Developer's Guide</b><br />
<b>Release 1.5</b><br />
E23376-02</td>
<td valign="bottom" align="right">
<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="225">
<tr>
<td>&nbsp;</td>
<td align="center" valign="top"><a href="toc.htm"><img src="./dcommon/gifs/toc.gif" alt="Go To Table Of Contents" /><br />
<span class="icon">Contents</span></a></td>
<td align="center" valign="top"><a href="index.htm"><img src="./dcommon/gifs/index.gif" alt="Go To Index" /><br />
<span class="icon">Index</span></a></td>
</tr>
</table>
</td>
</tr>
</table>
<hr />
<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100">
<tr>
<td align="center"><a href="title.htm"><img src="./dcommon/gifs/leftnav.gif" alt="Previous" /><br />
<span class="icon">Previous</span></a>&nbsp;</td>
<td align="center"><a href="intro.htm"><img src="./dcommon/gifs/rightnav.gif" alt="Next" /><br />
<span class="icon">Next</span></a></td>
<td>&nbsp;</td>
</tr>
</table>
<a name="BEGIN" id="BEGIN"></a></div>
<!-- class="header" -->
<div class="ind"><!-- End Header --><a id="Z400086710059" name="Z400086710059"></a>
<h1 class="preface">Preface</h1>
<p>This document describes how to work with the Lightweight User Interface toolkit.</p>
<a id="Z400086710000" name="Z400086710000"></a>
<h2 class="prefsect1">Before You Read This Document</h2>
<p>This guide is intended for developers creating Mobile Information Device Profile (MIDP) applications. This book is a tutorial in Lightweight UI Toolkit programming over MIDP. You should already have basic knowledge about Java&trade; UI libraries (for example, AWT and SWING) and understand how to use the Mobile Information Device Profile (MIDP) and the Connected Limited Device Configuration (CLDC).</p>
<p>For current discussion of LWUIT issues, see these online resources:</p>
<ul>
<li>
<p>LWUIT home page:&nbsp;&nbsp;<a href="http://lwuit.java.net/"><code>http://lwuit.java.net/</code></a></p>
</li>
<li>
<p>LWUIT community discussion forum:&nbsp;&nbsp;<a href="http://www.java.net/forums/mobile-embedded/lwuit"><code>http://www.java.net/forums/mobile-embedded/lwuit</code></a></p>
</li>
<li>
<p>LWUIT Blog:&nbsp;&nbsp;<a href="http://lwuit.blogspot.com/"><code>http://lwuit.blogspot.com/</code></a></p>
</li>
</ul>
<p>If you need help getting started with the Java programming language, try the New to Java Center:</p>
<p><code><a href="http://www.oracle.com/technetwork/topics/newtojava/overview/index.html">http://www.oracle.com/technetwork/topics/newtojava/overview/index.html</a></code></p>
<p>For a quick start with MIDP programming, read Learning Path: Getting Started with MIDP 2.0:</p>
<p><a href="http://developers.sun.com/mobility/learn/midp/midp20/"><code>http://developers.sun.com/mobility/learn/midp/midp20/</code></a></p>
<p>The following sites provide technical documentation related to Java ME technology:</p>
<p><code><a href="http://download.oracle.com/javame/">http://download.oracle.com/javame/</a></code></p>
<a id="Z400086710007" name="Z400086710007"></a>
<h2 class="prefsect1">How This Document Is Organized</h2>
<p>This guide contains the following chapters and appendices:</p>
<p><a href="intro.htm#CEFIEGJH">Chapter 1</a> introduces the Lightweight UI Toolkit library.</p>
<p><a href="widgets.htm#CEHGAEFC">Chapter 2</a> describes how to use Lightweight UI Toolkit widgets.</p>
<p><a href="lists.htm#CJBIDAJA">Chapter 3</a> explains how to use Lists.</p>
<p><a href="tabletree.htm#Z4002e6e1292041">Chapter 4</a> descries the Table and Tree components.</p>
<p><a href="dialogs.htm#CEHBCCIJ">Chapter 5</a> describes how to use Dialogs.</p>
<p><a href="layout.htm#BBJEHCEA">Chapter 6</a> shows how you can use Layouts.</p>
<p><a href="style.htm#BADGGABB">Chapter 7</a> explains how to use the Style object.</p>
<p><a href="theme.htm#BADBCIEI">Chapter 8</a> describes theme elements.</p>
<p><a href="resources.htm#CJBCGCDD">Chapter 9</a> describes the Resource Editor utility.</p>
<p><a href="painters.htm#CGFDAHFE">Chapter 10</a> explains how to use Painters.</p>
<p><a href="lwuitimpl.htm#Z4002e6d1292041">Chapter 11</a> describes the LWUIT implementation,</p>
<p><a href="htmlcomponent.htm#BBJIDHGF">Chapter 12</a> describes the HTMLComponent class.</p>
<p><a href="transitions.htm#CEHFEDIH">Chapter 13</a> describes how to use Transitions and Animations.</p>
<p><a href="extend.htm#CHECEECE">Chapter 14</a> describes how to author a new component from scratch.</p>
<p><a href="portability.htm#CEHEFJDI">Chapter 15</a> discusses general and device-specific portability issues.</p>
<p><a href="minifaq.htm#BBJGJGGH">Appendix A</a> summarizes frequently asked questions about LWUIT.</p>
<a id="Z400086710028" name="Z400086710028"></a>
<h2 class="prefsect1">Shell Prompts</h2>
<div class="inftblhruleinformal">
<table class="HRuleInformal" summary="Add Summary attribute value here." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0">
<col width="*" />
<col width="41%" />
<thead>
<tr align="left" valign="top">
<th align="left" valign="bottom" id="r1c1-t2">Shell</th>
<th align="left" valign="bottom" id="r1c2-t2">Prompt</th>
</tr>
</thead>
<tbody>
<tr align="left" valign="top">
<td align="left" id="r2c1-t2" headers="r1c1-t2">C shell</td>
<td align="left" headers="r2c1-t2 r1c2-t2"><span class="italic">machine-name</span><code>%</code></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r3c1-t2" headers="r1c1-t2">C shell superuser</td>
<td align="left" headers="r3c1-t2 r1c2-t2"><span class="italic">machine-name</span><code>#</code></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r4c1-t2" headers="r1c1-t2">Bourne shell and Korn shell</td>
<td align="left" headers="r4c1-t2 r1c2-t2"><code>$</code><br /></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r5c1-t2" headers="r1c1-t2">Bourne shell and Korn shell superuser</td>
<td align="left" headers="r5c1-t2 r1c2-t2"><code>#</code><br /></td>
</tr>
</tbody>
</table>
<br /></div>
<!-- class="inftblhruleinformal" -->
<a id="Z400086710032" name="Z400086710032"></a>
<h2 class="prefsect1">Typographic Conventions</h2>
<div class="inftblhruleinformal">
<table class="HRuleInformal" summary="Add Summary attribute value here." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0">
<col width="18%" />
<col width="38%" />
<col width="*" />
<thead>
<tr align="left" valign="top">
<th align="left" valign="bottom" id="r1c1-t3">Typeface</th>
<th align="left" valign="bottom" id="r1c2-t3">Meaning</th>
<th align="left" valign="bottom" id="r1c3-t3">Examples</th>
</tr>
</thead>
<tbody>
<tr align="left" valign="top">
<td align="left" id="r2c1-t3" headers="r1c1-t3"><code>AaBbCc123</code></td>
<td align="left" headers="r2c1-t3 r1c2-t3">The names of commands, files, and directories; on-screen computer output</td>
<td align="left" headers="r2c1-t3 r1c3-t3">Edit your<code>.login</code> file.
<p>Use <code>ls -a</code> to list all files.</p>
<p><code>% You have mail</code>.</p>
</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r3c1-t3" headers="r1c1-t3"><code>AaBbCc123</code></td>
<td align="left" headers="r3c1-t3 r1c2-t3">What you type, when contrasted with on-screen computer output</td>
<td align="left" headers="r3c1-t3 r1c3-t3"><code>%</code> <code>su</code>
<p><code>Password:</code></p>
</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r4c1-t3" headers="r1c1-t3"><span class="italic">AaBbCc123</span></td>
<td align="left" headers="r4c1-t3 r1c2-t3">Book titles, new words or terms, words to be emphasized. Replace command-line variables with real names or values.</td>
<td align="left" headers="r4c1-t3 r1c3-t3">Read Chapter 6 in the <span class="italic">User's Guide</span>.
<p>These are called <span class="italic">class</span> options.</p>
<p>You <span class="italic">must</span> be superuser to do this.</p>
<p>To delete a file, type <code>rm</code> <span class="italic">filename</span>.</p>
</td>
</tr>
</tbody>
</table>
<br /></div>
<!-- class="inftblhruleinformal" -->
<div align="center">
<div class="inftblnote"><br />
<table class="Note oac_no_warn" summary="" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
<tbody>
<tr>
<td align="left">
<p class="notep1">Note:</p>
Characters display differently depending on browser settings. If characters do not display correctly, change the character encoding in your browser to Unicode UTF-8.</td>
</tr>
</tbody>
</table>
<br /></div>
<!-- class="inftblnote" --></div>
<a id="Z400086710050" name="Z400086710050"></a>
<h2 class="prefsect1">Related Documentation</h2>
<p>The following table lists documentation related to this product.</p>
<div class="inftblhruleinformalwidemax">
<table class="HRuleInformalWideMax" title="Recommended Documentation" summary="related documentation topics with titles and URLs" dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0">
<col width="13%" />
<col width="*" />
<thead>
<tr align="left" valign="top">
<th align="left" valign="bottom" id="r1c1-t5">Topic</th>
<th align="left" valign="bottom" id="r1c2-t5">Title and URL</th>
</tr>
</thead>
<tbody>
<tr align="left" valign="top">
<td align="left" id="r2c1-t5" headers="r1c1-t5">JSR 118, MIDP 2.0</td>
<td align="left" headers="r2c1-t5 r1c2-t5"><span class="italic">Mobile Information Device Profile</span>
<p><a href="http://download.oracle.com/javame/"><code>http://jcp.org/en/jsr/detail?id=118</code></a></p>
</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r3c1-t5" headers="r1c1-t5">JSR 139, CLDC 1.1</td>
<td align="left" headers="r3c1-t5 r1c2-t5"><span class="italic">Connected Limited Device Configuration</span>
<p><a href="http://jcp.org/en/jsr/detail?id=139"><code>http://jcp.org/en/jsr/detail?id=139</code></a></p>
</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r4c1-t5" headers="r1c1-t5">JSR 184, 3D Graphics</td>
<td align="left" headers="r4c1-t5 r1c2-t5"><span class="italic">Mobile 3D Graphics API for J2ME</span>
<p><a href="http://jcp.org/en/jsr/detail?id=184"><code>http://jcp.org/en/jsr/detail?id=184</code></a></p>
</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r5c1-t5" headers="r1c1-t5">AWT docs</td>
<td align="left" headers="r5c1-t5 r1c2-t5"><a href="http://download.oracle.com/javase/6/docs/technotes/guides/awt/"><code>http://download.oracle.com/javase/6/docs/technotes/guides/awt/</code></a></td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r6c1-t5" headers="r1c1-t5">Swing docs</td>
<td align="left" headers="r6c1-t5 r1c2-t5"><code><a href="http://java.sun.com/javase/6/docs/technotes/guides/swing/index.html">http://java.sun.com/javase/6/docs/technotes/guides/swing/index.html</a></code></td>
</tr>
</tbody>
</table>
<br /></div>
<!-- class="inftblhruleinformalwidemax" -->
<a id="Z400086710055" name="Z400086710055"></a>
<h2 class="prefsect1">We Welcome Your Comments</h2>
<p>We are interested in improving our documentation and welcomes your comments and suggestions. Email your feedback to:</p>
<p><a href="mailto:LWUIT_COMMUNITY_WW@ORACLE.COM">LWUIT_COMMUNITY_WW@ORACLE.COM</a></p>
</div>
<!-- class="ind" -->
<!-- Start Footer -->
<div class="footer">
<hr />
<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
<col width="33%" />
<col width="*" />
<col width="33%" />
<tr>
<td valign="bottom">
<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100">
<col width="*" />
<col width="48%" />
<col width="48%" />
<tr>
<td>&nbsp;</td>
<td align="center"><a href="title.htm"><img src="./dcommon/gifs/leftnav.gif" alt="Previous" /><br />
<span class="icon">Previous</span></a>&nbsp;</td>
<td align="center"><a href="intro.htm"><img src="./dcommon/gifs/rightnav.gif" alt="Next" /><br />
<span class="icon">Next</span></a></td>
</tr>
</table>
</td>
<td class="copyrightlogo"><img class="copyrightlogo" src="./dcommon/gifs/oracle.gif" alt="Oracle Logo" /><br />
<span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2008, 2011,&nbsp;Oracle&nbsp;and/or&nbsp;its&nbsp;affiliates.&nbsp;All&nbsp;rights&nbsp;reserved.</span> <a href="./dcommon/html/cpyr.htm"><br />
<span class="copyrightlogo">Legal Notices</span></a></td>
<td valign="bottom" align="right">
<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="225">
<tr>
<td>&nbsp;</td>
<td align="center" valign="top"><a href="toc.htm"><img src="./dcommon/gifs/toc.gif" alt="Go To Table Of Contents" /><br />
<span class="icon">Contents</span></a></td>
<td align="center" valign="top"><a href="index.htm"><img src="./dcommon/gifs/index.gif" alt="Go To Index" /><br />
<span class="icon">Index</span></a></td>
</tr>
</table>
</td>
</tr>
</table>
</div>
<!-- class="footer" -->
</body>
</html>
